Skip to main content

Feeds

Feeds are added by the centurionV2-worker syncFeeds function from the package api3/dapi-management and are listed on the Feeds page.

Chains > Details > Configuration

  • Feeds: List of all feeds.
  • Details: Show the status, in detail, of the feed for a chain selected by the user.
  • Configuration: Maintain feed configuration properties.

Feed details

Graphs the feed's price and deviation status. A table below shows the data behind each data point on the graphs. The table also provide a link to view the raw data for each data point. A button is provided to switch chains.

Feed configuration

Contains a textarea of the JSON object that lists the configuration and status keys of a chain. The ability to change the feed's behavior is applied only through a few keys. The remainder of the keys are data that is changed by one or more workers.

Only the name, validators and category keys can be changed. Changes to the other keys are ignored. The other keys are only present for the purpose of review.

Access the configuration page after logging in as an admin. From the feeds's detail page, look for the button with the cog icon.

{
"feed_id": 8,
"name": "APE/USD",
"stage": "active",
"validators": {
"pyth": {
"id": "APE/USD"
},
"signed_data": {
"id": "APE/USD"
},
"redstone_api": {
"id": "APE"
},
"nodary_signed_api": {
"id": "APE/USD"
}
},
"category": "Cryptocurrency",
"statuses": {
"pyth": 0,
"error": 0,
"active": 1,
"warning": 0,
"heartbeat": 0,
"signed_data": 0,
"redstone_api": 0,
"nodary_signed_api": 0
}
}

Name

The feed's name (or dAPI name) is normally set when the feed is created by the feedsWorker from the list of feeds provided by dapi-management. It is very rare that the name needs to be changed. The feed's name must match the dAPI name held by the AirseekerRegistry contract when the pricesWorkers gets feed price value.

Validators

The list of validators is used by the historyWorker. It uses the validator prices of the signed_data validator to compare to the on-chains feed price in order to determine deviation. Other validators are not use to determine deviation but have value as a visual comparison on hte Centurion dashboard. Currently there are four:

  • pyth
  • signed_data
  • redstone_api
  • nodary_signed_api

Each validator has an id which is actually its name of the feed.

  • feed.name is validator.redstone_api.id
    • APE/USD is APE
  • feed.name is validator._signed_data.id
    • APE/USD is APE/USD

A list of validators and their feed ids can be found using the Validator symbol menu.

Category

The feed's category is normally set when the feed is created by the feedsWorker from the list of feeds provided by dapi-management. It is very rare that the category needs to be changed. Is sole purpose is for sorting and visual display in the Centurion UI.